@database "TrashManager.guide" @author "John Muir" @(c) " Copyright 1995 John Muir" @$VER: Trash Manager User Manual 0.93 (7.1.95) @width 78 @toc Main @index Index @node Main "Trash Manager User Manual" @{b}@{u}Trash Manager v0.93@{uu} Copyright 1995 John Muir Written by John Muir@{ub} @{" DISCLAIMER " link Disclaimer} @{" Introduction " link Introduction} @{" Requirements " link Requirements} @{" Installation " link Installation} @{" Using Trash Manager " link UsingTM} @{" Settings " link Settings} @{" Release Notes " link History} @{" Contact Info " link Contact} @endnode @node Disclaimer "DISCLAIMER" @{u}@{b}DISCLAIMER@{ub}@{uu} The information and the Trash Manager program are provided "as is" without warranty of any kind, either expressed or implied. The entire risk as to the accuracy of the information herein is assumed by you. John Muir does not warrant, guarantee, or make any representations regarding the use of, or the results of the use of, the information or the Trash Manager program in terms of correctness, accuracy, reliability, currentness, or otherwise. In no event will John Muir be liable for direct, indirect, incidental, or consequential damages resulting from any defect in the information or the Trash Manager program even if he has been advised of the possibility of such damages. @{b}@{u}FREEWARE@{ub}@{uu} Trash Manager is FREEWARE; it may be distributed by any means, anywhere. Please do not make any changes to the archive. If Trash Manager is distributed in or with any commercial media, I would like to be acknowledged for my efforts in the production of Trash Manager. @endnode @node Introduction "Introducing Trash Manager" @{u}@{b}Introduction@{ub}@{uu} Trash Manager is an App-Icon Trashcan program which runs on the Workbench. Trash Manager creates an Icon which appears on the Workbench screen. The Workbench user can drop other icons onto this App-Icon and Trash Manager will delete the selected file(s). This can be dangerous, so Trash Manager allows you to confirm the deletion of each file to make sure that you don't delete files that you don't want to. Since the program creates an icon on your Workbench, it allows you to to choose which icon is used, where it is placed and the name to give it. All of the settings that you use are saved into the Trash Manager icon. @endnode @node Requirements "Requirements" @{u}@{b}Requirements@{ub}@{uu} Trash Manager requires Kickstart and Workbench 3.0 or above (and a Commodore Amiga home Computer). Required libraries and software: gadtools.library v39 locale.library v38 Workbench @{u}@{b}Development@{ub}@{uu} Trash Manager was developed on an Amiga 3000/25 with 10Mb of RAM, and AmigaOS 3.1. Trash Manager was written in 'C' and compiled with SAS/C 6.51. @endnode @node Installation "Installing Trash Manager" @{u}@{b}Installing Trash Manager onto Your System@{ub}@{uu} The best way to install Trash Manager is by double- clicking on the Install Trash Manager icon. This executes an installer script which will copy all of the relevant files to the appropriate locations. If you don't like the installer, then follow these instructions; To install Trash Manager onto your hard disk, simply copy the TrashManager file and icon to any directory. The best place to put it would be the SYS:WBStartup drawer so that Workbench will start Trash Manager every time your start. If you are using any language other than english, copy the Catalogs//TrashManager.catalog to Locale:Catalogs//TrashManager.catalog. For example, I have installed the french catalog on my system; copy Catalogs/fran ais/TrashManager.catalog to Locale:Catalogs/fran This completes the installation of Trash Manager. @endnode @node UsingTM "Using Trash Manager" @{u}@{b}Using Trash Manager@{uu} Starting Trash Manager@{ub} To start Trash Manager, simply double-click on the TrashManager program icon from the Workbench, or type TrashManager at a Shell prompt. Trash Manager will create an App-Icon on the Workbench. @{b}Opening the Settings Window@{ub} Double-Clicking on the App-Icon will cause the Trash Manager @{" Settings " link Settings} window to open. The Trash Manager Settings window can also be opened from @{b}Commodities Exchange@{ub} with the @{b}Show Interface@{ub} button. @{b}Deleting Files@{ub} To delete files, simply click on a file on your Workbench, and drag it onto the Trash Manager App-Icon. @{b}Confirming Deletions@{ub} If the Confirm checkbox is checked on, then a window will appear asking you if you want to delete the file that you dropped onto the App-Icon. You are given four choices; @{b}Delete@{ub} - delete the current file. @{b}All@{ub} - delete the current file and all other files without confirming the others. @{b}Skip@{ub} - skip the current file. @{b}Cancel@{ub} - cancel the entire operation. @{b}Deleting Protected Files@{ub} Should a file that you have dropped onto the App-Icon be delete protected, then if the Protected cycle is set to @{b}Ask@{ub}, a window similar to that one above will open giving you the same options. In this case the @{b}All@{ub} button will cause Trash Manager to ignore delete protection for all files that it is asked to delete at that time. If one of the files could not be deleted, a window will open decribing the problem with an error message. You are given three choices in response; @{b}Skip@{ub} - skip the current file. @{b}Retry@{ub} - try deleting the file again. @{b}Cancel@{ub} - cancel the entire operation. The Retry option is useful if the problem is caused by an open Workbench window or another program which has opened the file. You can close the window or the file and press Retry to try deleting the file again. @{b}Quitting Trash Manager@{ub} There are several ways to quit Trash Manager; - Open the Settings window, and choose Quit from the Protect menu. - Run Trash Manager again. - Open Commodities Exchange, choose TrashManager, and press the 'Remove' button. @endnode @node Settings "Trash Manager Settings" @{u}@{b}Trash Manager Settings@{uu}@{ub} The Trash Manager Settings window is opened by double- clicking on to the Trash Manager App-Icon on the Workbench. The Settings window is separated into two parts. The first part labeled @{b}Delete@{ub} contains gadgets pertaining to deleting files. The second part is labeled @{b}App-Icon@{ub}, and it contains gadgets pertaining to the App-Icon used on the Workbench. Keyboard shortcuts are shown as @{u}underlined@{uu} characters. @{u}@{b}Delete@{ub}@{uu} @{b}@{u}P@{uu}rotected@{ub} - a cycle gadget which allows you to determine how Trash Manager handles Protected files. There are three choices; @{b}Ask@{ub} - ask before deleting protected files. @{b}Always@{ub} - always delete protected files. @{b}Never@{ub} - never delete protected files. The requester used when you are @{b}Ask@{ub}ed about a protected file is described in the @{" Using Trash Manager " link UsingTM} section. @{b}Con@{u}f@{uu}irm@{ub} - a checkbox which controls whether or not Trash Manager confirms the delete operation. The requester used to confirm a deletion is described in the @{" Using Trash Manager " link UsingTM} section. @{b}Enter Direcotry @{u}L@{uu}inks@{ub} - a checkbox which controls whether or not Trash Manager recursively deletes the files which are within the directory pointed to by a directory link. @{b}NOTE: If a directory link is dropped directly onto Trash Manager with an Icon, it will not be correctly identified.@{ub} Directory links which are sub-directories within a directory dropped onto Trash Manager @{i}will@{ui} be identified properly. @{b}Show @{u}E@{uu}rrors@{ub} - a checkbox which turns on and off the error requesters described in the @{" Using Trash Manager " link UsingTM} section. @{b}@{u}App-Icon@{ub}@{uu} @{b}@{u}I@{uu}con@{ub} - a string gadget and getfile button combination describing the filename for the icon that Trash Manager uses as an App-Icon on the Workbench. Use the getfile button to choose the icon with an ASL requester. If no icon is specified then the icon used by Trash Manager is used. Another way to choose an icon is by dropping it onto the App-Icon area in the Settings window. @{b}@{u}N@{uu}ame@{ub} - a string gadget describing the name of the App-Icon on the Workbench. @{b}UnSnaps@{u}h@{uu}ot@{ub} - if this checkbox is checked on, then the X and Y integer gadgets and the Get Position button will be ghosted, and the App-Icon will appear in the default location chosen by Workbench. Otherwise, the positions stored in the X and Y integer gadgets will be used. @{b}@{u}X@{ub}@{uu} - this contains the X coordinate of the location given to Workbench to place the App-Icon. @{b}@{u}Y@{ub}@{uu} - this contains the Y coordinate of the location given to Workbench to place the App-Icon. If an icon is already in the area used by the App-Icon at that X,Y position, then the App-Icon will be placed in the default location as if it was @{b}UnSnapshot@{ub}ed. @{b}Get Position@{ub} - this button will open a draggable window the size of the current App-Icon at the X,Y location. You can drag the window to change the X,Y coordinates for the App-Icon. To return to the settings window, close this Get Position window, or click on the Trash Manager Settings window. @{b}@{u}Buttons and Menus@{ub}@{uu} @{b}@{u}S@{uu}ave@{ub} - this button and menu item will cause the settings described in the Trash Manager Settings window to be saved to the Trash Manager program icon as well as into the global variables used within the Trash Manager program. Command-S will also activate the menu item. @{b}@{u}U@{uu}se@{ub} - this button and menu item will cause the settings described in the Trash Manager Settings window to be stored into the global variables in the Trash Manager program. Command-U will also activate the menu item. @{b}@{u}C@{uu}ancel@{ub} - this button and menu item will close the Trash Manager Settings window and cancel any changes made to the gadgets within the window. The Trash Manager Settings windows' close button has the same effect. Command-C will also avtivate the menu item. @{b}About...@{ub} - this menu item will open a requester telling you about Trash Manager. @{b}@{u}Q@{uu}uit@{ub} - this menu item will cause Trash Manager to stop running. Any changes to the settings will be discarded as with the Cancel operation. Command-Q will also activate the menu item. @endnode @node History "Notes on Changes to Trash Manager & things TO DO" @{u}@{b}History@{ub}@{uu} @{b}Version 0.9 (27.12.94)@{ub} - Released on IRC. @{b}Version 0.9a (27.12.94)@{ub} BUGFIX: Retry button didn't do anything. BUGFIX: Window wouldn't come to front if it was already open and the icon was double-clicked. @{b}Version 0.9b (27.12.94)@{ub} BUGFIX: Enter Directory Links text went over the Show Error checkbox with some fonts. @{b}Version 0.91 (30.12.94)@{ub} BUGFIX: UnSnapshot only worked if the icon that was used wasn't snapshotted itself. BUGFIX: If the tooltypes are updated while the program is running, changes to the App-Icon will take effect immediately. BUGFIX: Settings were not reset to default before reading ToolTypes so that NULL ToolTypes didn't result in using the default. This occured after notification of changes to the icon only. FEATURE: Drop icons onto the App-Icon area in the Settings window to set the icon used for the program. @{b}Version 0.92 (31.12.94)@{ub} BUGFIX: Numerous Enforcer hits while reading ToolTypes, and MungWall problems removed. FEATURE: Trash Manager is now a Commodity, and responds by default to 'lcommand t', as well as to the Show and Hide CX commands. Thanks to John Hughes for the suggestion! @{b}Version 0.92a (31.12.94)@{ub} - Now shows the hotkey in the Settings window titlebar. - Small changes getting ready for Localization. @{b}Version 0.93 (7.1.95)@{ub} - First public release FEATURE: Localized. French catalog included, with all sorts of grammar and word errors. I need some help translating the catalogs. Please E-Mail me if you're interested in volunteering a hour of your time to translate the program into your language. Trash Manager now requires locale.library v38. @{u}@{b}To Do@{uu}@{ub} - Put a real Get File image in the Icon GetFile button. Help anyone? - Move files to a trashcan directory instead of deleting. - Delete files that are already in this trashcan dir or - Remember where these files came from and put them back. Maybe: - Format Disks... someone get me a decent disk formatter and I'll think about it... @endnode @node Contact "Where to send your suggestions, comments, bugs, etc." @{b}@{u}Comments? Suggestions?@{uu}@{ub} Send any bug reports, suggestions, gifts to: (Internet) John_Muir@UManitoba.Ca (Snail Mail) John Muir 11 Wildwood Park Winnipeg, Manitoba R3T 0C7 CANADA @endnode